---
title: View and manage registered models
description: View and manage registered models and registered model versions in the NextGen Registry.
section_name: NextGen Registry
maturity: open-public-preview

---

# View and manage registered models {: #view-and-manage-registered-models }

In the Registry, model packages are grouped into _registered models_ as _versions_, allowing you to categorize them based on the business problem they solve. Once you add registered models, you can search and filter them. You can also view model and version info, share your registered models (and the versions they contain) with other users, and download model packages. Registered models can contain DataRobot (Workbench and Classic), custom, and external models as registered model versions.

## View registered models {: #view-registered-models }

In the top-left corner of the **Model directory** page, you can search and filter the table of registered models:

![](images/nxt-directory-search-filter.png)

* Click :fontawesome-solid-filter:{.lg } **Filter models** to apply or modify filters on the table of registered models. You can filter by **Target**, **Target type**, **Created by**, and **Last modified**, then click **Apply filters**:

    ![](images/nxt-directory-search-filter-apply.png)

    To clear an active filter, in the **Filters applied** row, you can click **x** on the filter badge. You can also click **Clear all** to remove every filter applied.

    ![](images/nxt-directory-search-filter-clear.png)

* Click :fontawesome-solid-magnifying-glass:{.lg } **Search** and enter the registered model name or a target name to locate a specific model in the table of registered models.

To the left of each model name, you can click the right arrow (:fontawesome-solid-chevron-right:{.lg }) to open the list of registered model versions without opening the registered model panel. You can click the down arrow (:fontawesome-solid-chevron-down:{.lg }) to close the list:

![](images/nxt-directory-expand-registered-model.png)

Once you locate the registered model or model version you are looking for, you can access a variety of information about the registered model or version.

### View registered model info {: #view-registered-model-info }

Click a registered model in the **Model directory** table to open the registered model and a list of associated versions. From that panel, you can access the **Target**, **Created by** information, **Last modified by** information, and **Registered Model ID**:

![](images/nxt-view-reg-model-info.png)

In addition, in the **Tags** group box, you can click **+ Add** to add key-value tags, view existing tags, or click **+ Add tag** add to existing tags:

![](images/nxt-view-reg-model-tags.png)

In the **Add key value(s)** dialog box, configure the following settings and then click **Add**:

![](images/nxt-add-reg-model-tags.png)

Setting     | Description
------------|------------------
Category    | Defaults to **Tag**; this is the only option for a registered model. To create a kay value of a different category, [create the key value in a registered model version](nxt-key-values).
Value type  | Select one of the following value types for the new key value: <ul><li>**String**</li><li>**Numeric**</li><li>**Boolean**</li><li>**URL**</li><li>**JSON**</li><li>**YAML**</li></ul>
Name        | Enter a descriptive name for the key in the key-value pair.
Value       | If you selected one of the following value types, enter the appropriate data:<ul><li>**String**: Enter any string up to 4 KB.</li><li>**Numeric**: Enter an integer or floating-point number.</li><li>**Boolean**: Select **True** or **False**.</li><li>**URL**: A URL in the format `scheme://location`; for example, `https://example.com`. DataRobot does not fetch the URL or provide a link to this URL in the user interface; however, in a downloaded compliance document, the URL may appear as a link.</li><li>**JSON**: Enter or upload JSON as a string. This JSON must parse correctly; otherwise, DataRobot won't accept it.</li><li>**YAML**: Enter or upload YAML as a string. DataRobot does not validate this YAML.</li></ul>
Description | _(Optional)_ Enter a description of the key value's purpose.

!!! tip
    You can click :fontawesome-solid-xmark: **Close** in the upper-left corner of the registered model panel at any time to return to the expanded **Model directory** table.

### View version info {: #view-version-info }

To open a registered model version, click the row for the version you want to access. The first time you open a version, it opens to the **Overview** tab; however, if you switch tabs, that selection persists as you open other versions. The registered model version panel includes the following tabs:

![](images/nxt-view-version-info.png)

 Tab        | Description 
------------|------------
Overview        | View basic model information for the model version, or locate more advanced information in the **Details** group box. You can also view the associated model artifacts in the **Related items** group box:<ul><li>For models built in Workbench, you can view the: **Use Case**, **Experiment**, **Model**, and **Training dataset**.</li><li>For models built in DataRobot Classic, you can view the: **Project**, **Model**, and **Training dataset**.</li></ul> In addition, you can click the model name and description to edit those fields.
Documents   | Generate [compliance documentation](nxt-compliance-doc) for the model version.
Deployments | View all model deployments for a registered model version, in addition to the associated deployment status information. You can click a **Deployment name** to open that deployment. If you haven't deployed the current model, or if you want to deploy it again, you can [click **Deploy** in the upper-right corner of the version panel](nxt-deploy-models).

!!! tip
    You can click :fontawesome-solid-xmark: **Close** in the upper-left corner of the registered model version panel at any time to return to the expanded **Model directory** table.

## Download a model package {: #download-a-model-package }

To download the model package associated with a registered model version, you can open the registered model version and, in the upper-right corner of the version panel, click the download icon (:material-download:{.lg }):

![](images/nxt-download-mlpkg-from-version.png)

## Share registered models {: #share-registered-models }

When the registered model or version panel is closed, in the actions menu, located in the last column for each registered model on the **Model directory** page, you can use the **Share** option to grant permissions to a registered model:

![](images/nxt-reg-model-actions.png)

When the registered model or version panel is open, in the upper-right corner of the info panel, you can click the share icon (:fontawesome-solid-share-nodes:{.lg }):

![](images/nxt-reg-model-share.png)

In the **Share** dialog box, you can search for a user to **Share with**, select an access level for that user, and click **Share**:

![](images/nxt-reg-model-share-dialog.png)

!!! note
    You can only share up to your own access level (a consumer cannot grant an editor role, for example) and you cannot downgrade the access of a collaborator with a higher access level than your own.

_Registered models_ are the model artifacts used for sharing, not _model packages_. When you share a registered model, you automatically share each model package contained in that registered model.

## Delete registered models {: #delete-registered-models }

When the registered model or version panel is closed, in the actions menu, located in the last column for each registered model on the **Model directory** page, you can use the **Delete** option to delete a registered model and all associated versions:

![](images/nxt-reg-model-actions.png)

When the registered model or version panel is open, in the upper-right corner of the info panel, you can click the delete icon (:fontawesome-solid-trash-can:{.lg}):

![](images/nxt-reg-model-delete.png)

To confirm the deletion of a registered model and all associated versions, in the **Delete registered model** dialog box, click **Delete**.

!!! warning
    Deleting a registered model deletes _all_ associated versions. You can't recover deleted registered models or versions.

